home *** CD-ROM | disk | FTP | other *** search
/ Aminet 44 / Aminet 44 (2001)(GTI - Schatztruhe)[!][Aug 2001].iso / Aminet / comm / www / http_post.readme < prev    next >
Text File  |  2001-07-04  |  4KB  |  133 lines
  1. Short:    Send POST query to HTTP server
  2. Uploader: Thomas Aglassinger <uais57el6tli3001@sneakemail.com>
  3. Version:  1.0
  4. Type:     comm/www
  5. Kurz:     Sende POST-Anfrage an HTTP-Server
  6. Requires: AmigaOS 3.x, AmiTCP or Miami
  7. Uploader: Thomas Aglassinger <uais57el6tli3001@sneakemail.com>
  8.  
  9. TITLE
  10.  
  11.   http_post - Send POST query to HTTP server
  12.  
  13. VERSION
  14.  
  15.   1.0
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <uais57el6tli3001@sneakemail.com>
  20.  
  21. DESCRIPTION
  22.  
  23.   Http_post is a little command line tool to retrieve content from a
  24.   web page via POST queries. It's mainly useful for web authors and
  25.   people with HTML/HTTP knowledge who want to automatize repetitive
  26.   tasks involving HTML forms.
  27.  
  28.   In order to use it, you have to know the exact location of a form,
  29.   and the names of input fields. You can learn them by looking at the
  30.   HTML code, especially the stuff included in <form>....</form>.
  31.  
  32.   If you don't know how to do this, this tool is of no use for you.
  33.   Maybe aminet:dev/gg/wget-bin.lha is what you are looking for.
  34.  
  35. SPECIAL REQUIREMENTS
  36.  
  37.   - AmigaOS 3.x
  38.   - AmiTCP or Miami (uses bsdsocket.library)
  39.  
  40. AVAILABILITY
  41.  
  42.   - Aminet mirrors, for example
  43.     ftp://wuarchive.wustl.edu/pub/aminet/comm/www/http_post
  44.  
  45. PRICE
  46.  
  47.   Freeware.
  48.  
  49. DISTRIBUTABILITY
  50.  
  51.   Freely distributable, as long no files are added or changed.
  52.  
  53. USAGE
  54.  
  55.   Start your TCP/IP stack, open a CLI and find some web page with a
  56.   form you want to get data from. Check the HTML code, and obtain the
  57.   URI of the script that processes the form, together with names of
  58.   the input fields. (Again, if you don't know how to do this, this
  59.   tool is not for you.)
  60.  
  61.   Http_post needs the following parameters, in the exact order:
  62.  
  63.   - your email address
  64.   - the location of the script
  65.   - any number of "name=value" pairs describing the input fields
  66.  
  67.   The email address is sent in a "From:" header, so if you screw
  68.   something up at the server side, the admin can contact you. While
  69.   you can specify any address you want, it is generally not a good
  70.   idea to specify fake addresses and deliberately screw something up
  71.   because an admin can trace you back anyway. It only makes him more
  72.   angry.
  73.  
  74.   The location of the script has to start with "http://".
  75.  
  76.   The "name=value" pairs each represent one input field "name" as it
  77.   you would have entered "value". Don't use URI escapes here, for
  78.   example don't type %20 to represent a space. Instead, use a space
  79.   and put the whole pair between quotes. Use CLI escapes, for example
  80.   "*N" to represent a linefeed. Don't leave a space before or after
  81.   the "=". The name is usually case sensitive.
  82.  
  83.   Example (to be entered as one line in CLI):
  84.  
  85.      http_post you@host.org
  86.                http://www.some.test/order.pl
  87.                user_id=hugo
  88.                product_id=134
  89.                amount=1
  90.  
  91.   The server status goes to stderr, the content of the server reply
  92.   goes to stdout. Thus, you can redirect the content to a file by
  93.   using ">file.txt" or whatever. In case of errors, the server usually
  94.   sends details in the content. These will also go to stdout, not
  95.   stderr.
  96.  
  97.   If you want to use the output in some other tool, consider prepeding
  98.   a <BASE> tag to resolve relative URIs like the document still is at
  99.   the server. (Hint: "echo" and ">>")
  100.  
  101. KNOWN BUGS
  102.  
  103.   Http_post is completely dumb, and will not follow any server
  104.   redirections. It cannot handle Secure-HTTP, deal with cookies, use
  105.   additional proxies, etc etc.
  106.  
  107.   You can only specify simple input fields, thus you cannot upload
  108.   files.
  109.  
  110.   Usabilitywise, the whole thing is crap.
  111.  
  112. SUPPORT
  113.  
  114.   Don't ask me about certain forms. Figure them out yourself.
  115.  
  116.   If you find any bugs, you can contact me at the address mentioned in
  117.   the AUTHOR section.
  118.  
  119. HISTORY
  120.  
  121.   Version 1.0, 1-May-2001
  122.   - initial release
  123.  
  124.  
  125. ============================= Archive contents =============================
  126.  
  127. Original  Packed Ratio    Date     Time    Name
  128. -------- ------- ----- --------- --------  -------------
  129.   101268   44484 56.0% 01-May-01 16:47:08  http_post
  130.     3766    1847 50.9% 01-May-01 16:53:16  http_post.readme
  131. -------- ------- ----- --------- --------
  132.   105034   46331 55.8% 03-May-101 03:03:52   2 files
  133.